home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / audio / alGetResource.z / alGetResource
Encoding:
Text File  |  1998-10-20  |  3.1 KB  |  67 lines
  1.  
  2.  
  3.  
  4. aaaallllGGGGeeeettttRRRReeeessssoooouuuurrrrcccceeee((((3333ddddmmmm))))                                          aaaallllGGGGeeeettttRRRReeeessssoooouuuurrrrcccceeee((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      alGetResource - get the resource associated with an audio port
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiioooo....hhhh>>>>
  13.  
  14.      iiiinnnntttt aaaallllGGGGeeeettttRRRReeeessssoooouuuurrrrcccceeee((((AAAALLLLppppoooorrrrtttt ppppoooorrrrtttt))))
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  17.      _p_o_r_t   expects the ppppoooorrrrtttt whose audio resource you desire.  This structure
  18.             is the returned value of an aaaallllOOOOppppeeeennnnPPPPoooorrrrtttt((((3333ddddmmmm)))) call.
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      An audio _r_e_s_o_u_r_c_e (see aaaallllRRRReeeessssoooouuuurrrrcccceeeessss((((3333ddddmmmm))))) is a globally visible object
  22.      upon which certain kinds of operations, such as getting and setting
  23.      parameters, can be performed. Audio devices are examples of resources.
  24.      Ports, too, are resources, and can support some of the same operations as
  25.      audio devices.
  26.  
  27.      aaaallllGGGGeeeettttRRRReeeessssoooouuuurrrrcccceeee(((()))) returns a resource associated with the given port that
  28.      you can then use, for example, as an argument to aaaallllGGGGeeeettttPPPPaaaarrrraaaammmmssss((((3333ddddmmmm)))) or
  29.      aaaallllCCCCoooonnnnnnnneeeecccctttt((((3333ddddmmmm)))).
  30.  
  31. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  32.      Upon successful completion, aaaallllGGGGeeeettttRRRReeeessssoooouuuurrrrcccceeee returns nonzero resource.  In
  33.      the event of an error, aaaallllGGGGeeeettttRRRReeeessssoooouuuurrrrcccceeee returns 0 and sets an error code
  34.      which can be retrieved with oooosssseeeerrrrrrrroooorrrr((((3333CCCC)))).
  35.  
  36.      aaaallllGGGGeeeettttRRRReeeessssoooouuuurrrrcccceeee can fail for the following reason:
  37.  
  38.      AAAALLLL____BBBBAAAADDDD____PPPPOOOORRRRTTTT   _p_o_r_t is either invalid or null.
  39.  
  40. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  41.      alOpenPort(3dm), alGetParams(3dm), alConnect(3dm), oserror(3C)
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.